//Copyright (c) 2007, Moq Contributors
//http://code.google.com/p/moq-contrib/
//All rights reserved.

//Redistribution and use in source and binary forms, 
//with or without modification, are permitted provided 
//that the following conditions are met:

//    * Redistributions of source code must retain the 
//    above copyright notice, this list of conditions and 
//    the following disclaimer.

//    * Redistributions in binary form must reproduce 
//    the above copyright notice, this list of conditions 
//    and the following disclaimer in the documentation 
//    and/or other materials provided with the distribution.

//    * Neither the name of the Moq Contributors nor the 
//    names of its contributors may be used to endorse 
//    or promote products derived from this software 
//    without specific prior written permission.

//THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 
//CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, 
//INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
//MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
//DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
//CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
//SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
//BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
//SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
//INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
//WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
//NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
//OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
//SUCH DAMAGE.

//[This is the BSD license, see
// http://www.opensource.org/licenses/bsd-license.php]

using System;

using Microsoft.Practices.ServiceLocation;

namespace Moq.Contrib.Indy
{
	/// <summary>
	/// Interface implemented by the <see cref="AutoMockContainer"/> so that 
	/// the various method overloads can receive a creation 
	/// function for the service, rather than just a type.
	/// </summary>
	public interface IMockContainer
	{
		/// <summary>
		/// Resolves a required service of the given type.
		/// </summary>
		T Resolve<T>();

		/// <summary>
		/// Gets or creates a mock for the given type, with 
		/// the default behavior specified by the factory.
		/// </summary>
		Mock<T> GetMock<T>() where T : class;

		/// <summary>
		/// Creates an instance of a class under test, 
		/// injecting all necessary dependencies as mocks.
		/// </summary>
		/// <typeparam name="T">Requested object type.</typeparam>
		T Create<T>();

		/// <summary>
		/// Creates an instance of a class under test using 
		/// the given activator function.
		/// </summary>
		/// <typeparam name="T">Requested object type.</typeparam>
		T Create<T>(Func<IMockContainer, T> activator);

		/// <summary>
		/// Registers the given service on the container.
		/// </summary>
		/// <typeparam name="TService">Service</typeparam>
		/// <typeparam name="TImplementation">The implementation of the service.</typeparam>
		void Register<TService, TImplementation>();

		/// <summary>
		/// Registers the given service instance on the container.
		/// </summary>
		/// <typeparam name="TService">Service type.</typeparam>
		/// <param name="instance">Service instance.</param>
		void Register<TService>(TService instance) where TService : class;

		/// <summary>
		/// Registers the given service creation delegate on the container.
		/// </summary>
		/// <typeparam name="TService">Service type.</typeparam>
		void Register<TService>(Func<IMockContainer, TService> activator);

		/// <summary>
		/// Gets the locator.
		/// </summary>
		IServiceLocator Locator{ get; }
	}
}